'Declaration
 
Public Overloads Function OMRDetectOvalMarks( _
   ByVal ImageID As Integer, _
   ByRef Areas() As Integer, _
   ByVal AreasCount As Integer, _
   ByVal Sensitivity As Double, _
   ByRef Confidence() As Integer, _
   ByVal HasCharacter As Boolean _
) As Integer()

public int[] OMRDetectOvalMarks( 
   int ImageID,
   ref int[] Areas,
   int AreasCount,
   double Sensitivity,
   ref int[] Confidence,
   bool HasCharacter
)

public function OMRDetectOvalMarks( 
    ImageID: Integer;
   var  Areas: Integerarray of;
    AreasCount: Integer;
    Sensitivity: Double;
   var  Confidence: Integerarray of;
    HasCharacter: Boolean
): array of Integer; 

public function OMRDetectOvalMarks( 
   ImageID : int,
   Areas : int[],
   AreasCount : int,
   Sensitivity : double,
   Confidence : int[],
   HasCharacter : boolean
) : int[];

public: int[]* OMRDetectOvalMarks( 
   int ImageID,
   ref int[]* Areas,
   int AreasCount,
   double Sensitivity,
   ref int[]* Confidence,
   bool HasCharacter
) 

public:
array<int>^ OMRDetectOvalMarks( 
   int ImageID,
   array<int>^% Areas,
   int AreasCount,
   double Sensitivity,
   array<int>^% Confidence,
   bool HasCharacter
) 

Parameters

ImageID

GdPicture image identifier.

Areas

Array of Integer. This parameter is used as a reference to the location of the OMR Fields. Where each quadruplet (left, top, width, height) corresponds to a rectangle surrounding a single OMR field. For example, if 40 entries exist in Areas, there will be 10 OMR Fields to be investigated whether they were checked (filled) or not.

AreasCount

Number of Rectangles sent to the method. Basically, the length of Areas().

Sensitivity

How sensitive the method is to degree of filling of the OMR field in respect to the size of the field itself. Higher values will result in more tolerant results where semi filling of the field would yield positive results. Lower values will result in less tolerant results where maximum filling of the field only would yield positive results Sensitivity greatly affects the confidence value returned. Range from 0.0 to 1.0. If different values are entered, they will automatically be limited to this range. Default Value is 0.5.

Confidence

Reference to a 1-Dimensional array of Integers. Must be initialized and sent to method. After the method is called, the array elements would correspond to the confidence of the result returned by the method. For Examples, if Confidence[0] = 40, then the first OMR field result returned is 40% accurate. It is important to mark that Confidence is greatly affected by "Sensitivity". Confidence value is a mixture of how much the sensitivity standard was accomplished, how much was it exceeded or unmet. It also details the respect of the filling to the size of the border and the regularity of the border.

HasCharacter

Whether the OMR field contains a character inside it or not.

Return Value

All Rectangles sent to the method via array Areas can be of any size or location, as long as they: 1. Surround the OMR Field completely. 2. Do not intersect with borders of OMR field. 3. Do not intersect with other objects in the document.

Closer, more accurate selection of those rectangles will yield faster and more accurate results.

"Sensitivity" affects the "Confidence" returned. Low Sensitivity would return high results of Confidence for empty fields, but low Confidence results for semi filled fields. High Sensitivity would return low results of Confidence for empty fields, but High Confidence results for semi filled fields. It is important to note that "Confidence" is the degree of confidence that sensitivity rules are met, and not the actual filling or not filling of the field. If sensitivity values do not correspond properly to the filling, the confidence would spell to the sensitivity value more than the actual filling or not filling of the field.

If many documents are scanned of the same form, and the scanning orientation or quality is not guaranteed, the GdPicture Anchoring System can be used to specify the orientation of each document and the translation made to each document from the one where the user selected their Areas (surrounding rectangles). Then you can manually change the rectangle arrays to each document via the data provided.

To obtain best and most accurate results, images have to be of good quality, at least 200 dpi is recommended.

This method is used in the "OMR" Demo.

This method requires the ADR & OMR component to run.

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
CreateAnchorTemplate Method